Set Up Google reCAPTCHA

Protect your platform from bots and spam using Google reCAPTCHA v3. This guide walks you through integrating reCAPTCHA with your BotSailor Reseller account step-by-step to ensure secure form submissions and a smoother user experience.

🛠️ What is Google reCAPTCHA?

Google reCAPTCHA is a free service from Google that helps protect your website from spam and abuse. Unlike the older versions, reCAPTCHA v3 works in the background by assigning a score to each user interaction, allowing legitimate users to proceed without solving any challenge.

⚙️ Why Use reCAPTCHA with BotSailor?

Using Google reCAPTCHA in your BotSailor reseller panel adds an extra layer of security to public-facing forms like login, signup, or lead generation. It helps:

• Prevent bot signups or attacks

• Reduce spam submissions

• Protect user data and your platform reputation

🔐 Prerequisites

• A Google account

• A registered domain (e.g., bizzfair.com)

• Admin access to your BotSailor Reseller Dashboard

✅ Step-by-Step Guide to Setup Google reCAPTCHA v3

Step 1: Register Your Site on Google reCAPTCHA

1. Visit https://www.google.com/recaptcha/admin 

2. Click "+ Create" or "Add" to register a new site

3. Fill in the details:

• Label: Any name (e.g., biz)

• reCAPTCHA type: Select Score based (v3)

• Domains: Add your domain (e.g., bizzfair.com)

• Owner email: Should be prefilled

4. Click Submit
   
   
   
   
   
   

👉 Note: If you see “Please specify a domain name,” ensure your domain is typed correctly and without http:// or www..

Step 2: Copy Your Site Key and Secret Key

After registering the domain, Google will show two important keys:

• Site Key – used on your website frontend

• Secret Key – used for backend verification
  
  
  
  
  

👉 Keep these keys secure and do not share them publicly.

Step 3: Enable reCAPTCHA from BotSailor Reseller Panel

1. Login to your BotSailor Reseller Dashboard

2. Navigate to Settings → Google reCAPTCHA (see left sidebar)

3. Paste the Site Key and Secret Key into their respective fields

4. Set the Minimum Score (default: 0.6). A higher score means stricter spam detection

5. Enable the toggle switch

6. Click Save
   
   
   
   
   
   
   

✅ You should see a green success message: “Settings have been saved successfully.”

💡 Best Practices and Tips

• For most use cases, a minimum score of 0.5–0.7 is ideal

• Always verify that the domain entered in reCAPTCHA settings matches your BotSailor domain

• Test the form after integration to ensure it behaves as expected

• You can monitor traffic and scores from the Google reCAPTCHA dashboard

🧩 Troubleshooting

Issue: “Please specify a domain name” in Google panel
Solution: Ensure you’ve added a valid domain name like bizzfair.com without any protocol (http/https).

Issue: CAPTCHA not working after setup
Solution: Double-check that the keys are correct and saved in the BotSailor panel. Also, verify the reCAPTCHA script is correctly embedded on your frontend (if applicable).

Frequently Asked Questions (FAQs)

What is the difference between reCAPTCHA v2 and v3?
reCAPTCHA v2 shows users a challenge (like selecting images), while v3 works silently in the background and assigns a score to each interaction to determine if it's human or bot.

Do I need to install any plugin to use reCAPTCHA in BotSailor?
No plugin is required. BotSailor has a built-in integration feature in the reseller panel for Google reCAPTCHA v3.

Where can I find the reCAPTCHA settings in my BotSailor Reseller Dashboard?
Log in to your reseller dashboard and navigate to Settings → Google reCAPTCHA from the sidebar.

What is the recommended score threshold to use?
A score between 0.5 and 0.7 is ideal. Higher scores offer stricter bot detection but may mistakenly flag real users in rare cases.

Can I use the same reCAPTCHA keys for multiple domains?
No. Each domain should be registered separately in the Google reCAPTCHA admin panel, and unique keys should be used for each.

Why am I getting a 'Please specify a domain name' error during setup?
This usually means the domain was entered with "http://" or "www." — remove those and enter just the domain (e.g., bizzfair.com).

What if reCAPTCHA isn’t working after integration?
Double-check that both Site Key and Secret Key are correctly pasted in the settings. Also, ensure reCAPTCHA is enabled and the correct domain is registered.

Can reCAPTCHA v3 be used on all forms in BotSailor?
It’s typically used on public-facing forms like login, signup, or lead generation forms. BotSailor handles integration automatically once configured.

Where can I monitor suspicious activity or bot detection scores?
You can track this directly from the Google reCAPTCHA admin dashboard after logging into https://www.google.com/recaptcha/admin.

Is reCAPTCHA required for BotSailor to function properly?
No, but it's strongly recommended to protect your reseller platform from spam, bots, and potential abuse.